home *** CD-ROM | disk | FTP | other *** search
/ c't freeware shareware 2001 January / CT_SW0101.ISO / pc / software / kommunik / multimed / snakcarb.sit / Snak 4.6.3 Carbon / Snak Manual.rsrc / TEXT_139.txt < prev    next >
Text File  |  2001-05-12  |  2KB  |  51 lines
  1.  
  2. User Definable Menus
  3. The contents of the Tools menu and the Contextual menus can be set up according to needs of the user. The menu items can be changed, deleted or added by editing the text file "Menu Definitions" that is in the Scripts Folder.
  4.  
  5. There are several sections in this file, each starting with a line with the title in square brackets [], beginning with [TOOLSMENU].
  6.  
  7. Each menu item is one line in this file, and consists of a title and an optional command portion that begins with /.
  8.  
  9. [QUERYCONTEXTUALMENU]
  10. Whois/whois $T
  11. CTCP
  12. .Ping/ctcp $T ping
  13. .Finger/ctcp $T finger
  14. .Version/ctcp $T version
  15. .Time/ctcp $T time
  16. .Userinfo/ctcp $T userinfo
  17. .ClientInfo/ctcp $T clientinfo
  18. DCC
  19. .Send/dcc send $T
  20.  
  21. As explained in the chapter on ircII scripting the $T variable contains the name of the current channel or query window. In the example above we see the contextual menu for the query window which works on the nick we are talking to.
  22.  
  23. Submenus are specified with one line with the menu title, followed by lines with one or more dots before the title. The dots indicate the submenu level.
  24.  
  25. The above example has two submenus, named CTCP and DCC. The CTCP sub menu has six items in it, and the DCC submenu has one item. 
  26.  
  27. The command portion is executed when the item is selected in the menu.
  28.  
  29. Please see chapter "ircII Scripting" for more information on the scripting variables and the scripting language. 
  30.  
  31. If you make additions to the menus that you think are useful to others, you are welcome to send them to me and I might add them to future releases of Snak. 
  32.  
  33.  
  34. The Tools Menu
  35. The tools menu is intended for functions that operate on selections in the userlist, so to use most of the built in Tool functions, you need to select a nick in the userlist and use the menu.  
  36.  
  37. Two of the scripting variables that Snak provide are especially suited to be used in Tool functions $E and $F:
  38.  
  39. The $E variable returns the nick of the first selected user and is used in functions like /whois. 
  40.  
  41. The $F variable returns the user and host information that Snak knows about the selected Nick. This is useful in functions like /kick or /ban
  42.  
  43. The Respond function will open a query window to the last person that sent you a private message.
  44.  
  45.  
  46. The Contextual menus
  47. Contextual menus (CM for short) was introduced with OS 8, and is invoked by holding down the control key when clicking somewhere. Snak supports CM in the userlists, the channel window, the console window and Query windows.
  48.  
  49.  
  50.  
  51.